PsL Monthly 1993 December

home *** CD-ROM | disk | FTP | other *** search

/ PsL Monthly 1993 December / PSL Monthly Shareware CD-ROM (December 1993).iso / prgmming / dos / pascal / rm_trbo.exe / RMASTER.DOC < prev next >

Wrap

Text File | 1991-09-25 | 20.4 KB | 774 lines

Raster Master V2.0 -- SHAREWARE RELEASE -- (C) Copyright 1991 By Scarborough Digital. All Rights Reserved. T A B L E O F C O N T E N T S DISCLAIMER.................................1 ACKNOWLEDGEMENTS...........................1 REQUIREMENTS...............................1 LICENSING..................................1 CUSTOMER SERVICE...........................1-2 INTRODUCTION...............................2 GETTING STARTED............................2 SELECTING COLORS...........................4 SELECTING TOOLS............................4 TOOL DESCRIPTIONS..........................4-5 CHANGING THE ZOOM SIZE.....................5 CHANGING FILE FORMATS......................6 USING THE FILE REQUESTER...................7-8 ADDING GRAPHICS TO YOUR PROGRAMS...........8 REGISTERING RASTER MASTER..................9 DISCLAIMER ----------- Scarborough Digital will not be liable for any damage that may result from the use of this program. This program comes with NO WARRANTY written or implied. Use this program at your own risk. ACKNOWLEDGMENTS ---------------- IBM is a registered trademark of International Business Machines Inc. Turbo Pascal is a trademark of Borland International. Windows is a registered trade mark of Microsoft Inc. REQUIREMENTS ------------- IBM Compatible Machine Mouse VGA card DOS 3.3 or higher (or any Compatible DOS) Turbo Pascal 5/5.5/6 LICENSING ---------- This program has been released for distribution as shareware. You have been given the chance to sample the full capabilities of Raster Master without risk! You are granted a 60 day evaluation period to use Raster Master, if you find that Raster Master is a valuable tool and expect to use it beyond the evaluation period, then you are expected to register. The cost of registering Raster Master is $25.00. See REGISTER.TXT. For a site licence please call or write. CUSTOMER SERVICE ----------------- If you have any questions, comments, or suggestions, Scarborough Digital can be contacted through several means. VOICE PHONE - The Scarborough Digital phone number is (416) 438-5049 Page 1 BBS - CRS Members leave a message to Neil Bojkovski. - Rose Media Members leave a message to Nick Onoufriou. - PC Connect (416) 733-9052 leave a message to Nick Onoufriou at the main conference. - We also monitor the Shareware and Pascal conferences on the major Networks. MAIL - Scarborough Digital 7305 Woodbine Ave., Unit 45 Markham, Ontario Canada L3R 3V7 INTRODUCTION ------------- Raster Master is a graphic editor that helps Turbo Pascal Programmers add graphics to their programs. Raster Master is capable of handling graphics up to 100 X 100 pixels in size with 16 colors. The popular PCX format is supported along with the Windows ICO format used for MS Windows Icons. Other formats are also supported to make adding graphics to your programs simple. GETTING STARTED ---------------- If you have not yet tried the program, please try it now, this will allow you to get a better understanding for the proceeding information. Remember to use the door in order to exit the program. The Raster Master display is divided into five areas, the top left corner contains the actual size image of the icon, the far right contains a zoom image of the icon, the lower left contains a box with the 'RM' letters, above that is the tool box, and at the lower right is the color box. All drawing and editing is done in the zoom area. Page 2 Actual Size Box Zoom Box ╔══════════════════╗ ╔═╤═╤═╤═╤═╤═╤═╤═╤═╤═╤═╤═╤═╤═╤═╤═╤═╤═╤═╤═╤═╤═╗ ║ ║ ╟─┼─┼─┼─┼─┼─┼─┼─┼─┼─┼─┼─┼─┼─┼─┼─┼─┼─┼─┼─┼─┼─╢ ║ ║ ╟─┼─┼─┼─┼─┼─┼─┼─┼─┼─┼─┼─┼─┼─┼─┼─┼─┼─┼─┼─┼─┼─╢ ║ ║ ╟─┼─┼─┼─┼─┼─┼─┼─┼─┼─┼─┼─┼─┼─┼─┼─┼─┼─┼─┼─┼─┼─╢ ║ ║ ╟─┼─┼─┼─┼─┼─┼─┼─┼─┼─┼─┼─┼─┼─┼─┼─┼─┼─┼─┼─┼─┼─╢ ║ ║ ╟─┼─┼─┼─┼─┼─┼─┼─┼─┼─┼─┼─┼─┼─┼─┼─┼─┼─┼─┼─┼─┼─╢ ║ ║ ╟─┼─┼─┼─┼─┼─┼─┼─┼─┼─┼─┼─┼─┼─┼─┼─┼─┼─┼─┼─┼─┼─╢ ╚══════════════════╝ ╟─┼─┼─┼─┼─┼─┼─┼─┼─┼─┼─┼─┼─┼─┼─┼─┼─┼─┼─┼─┼─┼─╢ ╟─┼─┼─┼─┼─┼─┼─┼─┼─┼─┼─┼─┼─┼─┼─┼─┼─┼─┼─┼─┼─┼─╢ Tool Box ╟─┼─┼─┼─┼─┼─┼─┼─┼─┼─┼─┼─┼─┼─┼─┼─┼─┼─┼─┼─┼─┼─╢ ╔══════════════════╗ ╟─┼─┼─┼─┼─┼─┼─┼─┼─┼─┼─┼─┼─┼─┼─┼─┼─┼─┼─┼─┼─┼─╢ ║ ┌──────┐ ┌──┐ ║ ╟─┼─┼─┼─┼─┼─┼─┼─┼─┼─┼─┼─┼─┼─┼─┼─┼─┼─┼─┼─┼─┼─╢ ║ │ 1 │ │6 │ ║ ╟─┼─┼─┼─┼─┼─┼─┼─┼─┼─┼─┼─┼─┼─┼─┼─┼─┼─┼─┼─┼─┼─╢ ║ └──────┘ └──┘ ║ ╟─┼─┼─┼─┼─┼─┼─┼─┼─┼─┼─┼─┼─┼─┼─┼─┼─┼─┼─┼─┼─┼─╢ ║ ┌──────┐ ┌──┐ ║ ╟─┼─┼─┼─┼─┼─┼─┼─┼─┼─┼─┼─┼─┼─┼─┼─┼─┼─┼─┼─┼─┼─╢ ║ │ 2 │ │7 │ ║ ╟─┼─┼─┼─┼─┼─┼─┼─┼─┼─┼─┼─┼─┼─┼─┼─┼─┼─┼─┼─┼─┼─╢ ║ └──────┘ └──┘ ║ ╟─┼─┼─┼─┼─┼─┼─┼─┼─┼─┼─┼─┼─┼─┼─┼─┼─┼─┼─┼─┼─┼─╢ ║ ┌──────┐ ┌──┐ ║ ╟─┼─┼─┼─┼─┼─┼─┼─┼─┼─┼─┼─┼─┼─┼─┼─┼─┼─┼─┼─┼─┼─╢ ║ │ 3 │ │8 │ ║ ╟─┼─┼─┼─┼─┼─┼─┼─┼─┼─┼─┼─┼─┼─┼─┼─┼─┼─┼─┼─┼─┼─╢ ║ └──────┘ └──┘ ║ ╟─┼─┼─┼─┼─┼─┼─┼─┼─┼─┼─┼─┼─┼─┼─┼─┼─┼─┼─┼─┼─┼─╢ ║ ┌──────┐ ┌──┐ ║ ╟─┼─┼─┼─┼─┼─┼─┼─┼─┼─┼─┼─┼─┼─┼─┼─┼─┼─┼─┼─┼─┼─╢ ║ │ 4 │ │9 │ ║ ╟─┼─┼─┼─┼─┼─┼─┼─┼─┼─┼─┼─┼─┼─┼─┼─┼─┼─┼─┼─┼─┼─╢ ║ └──────┘ └──┘ ║ ╟─┼─┼─┼─┼─┼─┼─┼─┼─┼─┼─┼─┼─┼─┼─┼─┼─┼─┼─┼─┼─┼─╢ ║ ┌──────┐ ┌──┐ ║ ╟─┼─┼─┼─┼─┼─┼─┼─┼─┼─┼─┼─┼─┼─┼─┼─┼─┼─┼─┼─┼─┼─╢ ║ │ 5 │ │10│ ║ ╟─┼─┼─┼─┼─┼─┼─┼─┼─┼─┼─┼─┼─┼─┼─┼─┼─┼─┼─┼─┼─┼─╢ ║ └──────┘ └──┘ ║ ╟─┼─┼─┼─┼─┼─┼─┼─┼─┼─┼─┼─┼─┼─┼─┼─┼─┼─┼─┼─┼─┼─╢ ║ ┌──┐ ┌──┐ ┌──┐ ║ ╟─┼─┼─┼─┼─┼─┼─┼─┼─┼─┼─┼─┼─┼─┼─┼─┼─┼─┼─┼─┼─┼─╢ ║ │11│ │12│ │13│ ║ ╟─┼─┼─┼─┼─┼─┼─┼─┼─┼─┼─┼─┼─┼─┼─┼─┼─┼─┼─┼─┼─┼─╢ ║ └──┘ └──┘ └──┘ ║ ╟─┼─┼─┼─┼─┼─┼─┼─┼─┼─┼─┼─┼─┼─┼─┼─┼─┼─┼─┼─┼─┼─╢ ║ ┌──┐ ┌──┐ ┌──┐ ║ ╟─┼─┼─┼─┼─┼─┼─┼─┼─┼─┼─┼─┼─┼─┼─┼─┼─┼─┼─┼─┼─┼─╢ ║ │14│ │15│ │16│ ║ ╟─┼─┼─┼─┼─┼─┼─┼─┼─┼─┼─┼─┼─┼─┼─┼─┼─┼─┼─┼─┼─┼─╢ ║ └──┘ └──┘ └──┘ ║ ╟─┼─┼─┼─┼─┼─┼─┼─┼─┼─┼─┼─┼─┼─┼─┼─┼─┼─┼─┼─┼─┼─╢ ╚══════════════════╝ ╟─┼─┼─┼─┼─┼─┼─┼─┼─┼─┼─┼─┼─┼─┼─┼─┼─┼─┼─┼─┼─┼─╢ ╟─┼─┼─┼─┼─┼─┼─┼─┼─┼─┼─┼─┼─┼─┼─┼─┼─┼─┼─┼─┼─┼─╢ ╟─┼─┼─┼─┼─┼─┼─┼─┼─┼─┼─┼─┼─┼─┼─┼─┼─┼─┼─┼─┼─┼─╢ ╟─┼─┼─┼─┼─┼─┼─┼─┼─┼─┼─┼─┼─┼─┼─┼─┼─┼─┼─┼─┼─┼─╢ ╟─┼─┼─┼─┼─┼─┼─┼─┼─┼─┼─┼─┼─┼─┼─┼─┼─┼─┼─┼─┼─┼─╢ ╟─┼─┼─┼─┼─┼─┼─┼─┼─┼─┼─┼─┼─┼─┼─┼─┼─┼─┼─┼─┼─┼─╢ ╚═╧═╧═╧═╧═╧═╧═╧═╧═╧═╧═╧═╧═╧═╧═╧═╧═╧═╧═╧═╧═╧═╝ RM Box ╔══════════════════╗ ║ ║ ║ **** * * ║ Color Box ║ * * ** ** ║ ╔════════════════════════════════════════════╗ ║ **** * * * ║ ║ ┌──────┐ ┌──┐ ┌──┐ ┌──┐ ┌──┐ ┌──┐ ┌──┐ ┌──┐║ ║ * * * * ║ ║ │ │ │ │ │ │ │ │ │ │ │ │ │ │ │ │║ ║ * * * * ║ ║ └──────┘ └──┘ └──┘ └──┘ └──┘ └──┘ └──┘ └──┘║ ║ ║ ║ ║ ╚══════════════════╝ ╚════════════════════════════════════════════╝ 1. Open 6. Undo 11. Circle 16. Filled Square 2. Save 7. Grid 12. Filled Circle 3. CLR 8. Door 13. Spray 4. View 9. Paint 14. Dot 5. Clip 10. Line 15. Square Page 3 SELECTING COLORS ----------------- To select a color move the mouse pointer in color box area, point to one of the colors and press the left mouse button. SELECTING TOOLS ---------------- To select any of the tools move the mouse pointer in the tool box area, point to one of the tools and press the left mouse button. TOOL DESCRIPTION ----------------- -Open : Read image file (see USING THE FILE REQUESTER) (see CHANGING FORMATS) -Save : Save Image to file (see CHANGING FORMATS) (see USING THE FILE REQUESTER) -Dot : Point where to plot dot, press left mouse button. -Line : Point where to plot the starting end of the line and press left mouse button, move pointer to extend the line, release button. -Square : Point where to plot the starting corner of the square and press left mouse button, move pointer to expand the square, release button. -Filled Square : Point where to plot the starting corner of the square and press left mouse button, move pointer to expand the square, release button. -Circle : Point where the centre of the circle will be and press left mouse button, move pointer to expand the circle, release button. -Filled Circle : Point where the centre of the circle will be and press left mouse button, move pointer to expand the circle, release button. Page 4 -Spray : Point where to spray dots and press left mouse button, release button. -Paint : Point to area that you want painted and press left mouse button, release button. -Undo : Removes the last thing you plotted. -Grid : Toggles the grid in the zoom box. -CLR : Clears the display. -Door : Allows you to exit the program. -View : Allows you to view your image in different resolutions. -Clip : Point where to mark the starting corner of the clip area and press left the left mouse button, move pointer to expand the clip area, release button. -Open : Reads file in the clipped area. -Save : Saves image area that is clipped. -HFLIP : Flips the image horizontally -VFLIP : Flips the image vertically. -Up : Scrolls the image up. -Down : Scrolls the image down. -Left : Scrolls the image to the left. -Right : Scrolls the image to the right. CHANGING THE ZOOM SIZE ----------------------- Move the pointer to the Grid gadget and press the RIGHT mouse button. Page 5 CHANGING FILE FORMATS ---------------------- By moving the mouse pointer over the SAVE or OPEN gadget and pressing the RIGHT mouse button you are given a list of file formats. Select a format and press the OK gadget. BGF - Bgi Graphics Format A small unit is provided for reading and writing BGF file, see RWBgf.pas, Demo1.pas, and Demo2.pas for demonstration on how to load graphics into your programs using this format) DEF - HEX type format This type of file is a regular text file where each pixels color is represented by a HEX digit from 0-F) This format is provided as a means of adding features to your graphics that Raster Master is not capable of. eg. Writing a small program to convert a DEF file to ANSI. (See RWDef.pas, Demo3.pas, and Demo4.pas for demonstration on using the DEF format.) ICO - Windows Icon Format Remember when saving in this format that only the first 32 X 32 pixels starting from the left top corner will be saved. If you clip save the file and its less than 32 X 32 the image will be padded to 32 X 32. (Register Raster Master and you will receive full source code for reading and writing your own ICO files) PCX - Used By PC Paintbrush and other popular programs. Images that are larger than 100 X 100 pixels will be truncated. Support is provided for images with 16 colors or less. (Register Raster Master and you will receive full source code for reading and writing your own PCX files. These routines are high level and are capable of reading and writing images from 2 to 256 colors) CON - Creates a text file containing a Constant variable of the image which can be included in your programs. (See Demo5.pas) Page 6 USING THE FILE REQUESTER ------------------------- ╔════════════════════════╗ ║ ║ ╠════════════════════════╣ ║ 1 ║ 1. File Path Box ╠═══════════════════╦════╣ 2. File Name Box ║ ║╔══╗║ 3. Up Gadget ║ ║║3 ║║ 4. Scroller Gadget ║ ║╚══╝║ 5. Down Gadget ║ ║╔╦╦╗║ 6. Parent Gadget ║ ║║4 ║║ 7. Cancel Gadget ║ ║╠╩╩╣║ 8. OK Gadget ║ ║║ ║║ ║ ║║ ║║ ║ ║║ ║║ ║ ║║ ║║ ║ ║║ ║║ ║ ║╚══╝║ ╠═══════════════════╣╔══╗║ ║ 2 ║║5 ║║ ╠═══════════════════╝╚══╝║ ║╔═════╗╔═════════╗╔════╗║ ║║ 6 ║║ 7 ║║ 8 ║║ ║╚═════╝╚═════════╝╚════╝║ ╚════════════════════════╝ SELECTING A FILENAME ------------------------ If it appears in the file list, point to the file and press the left mouse button, point to OK gadget and press the left mouse button. OR Point to the filename box and press the left mouse button, enter the name, point to OK gadget and press left mouse button. CHANGING THE PATH --------------------- Point to the parent gadget and press the left mouse button. OR Point to a file directory in the file list box and press the left mouse button. OR Point to the file path box and press the left mouse button, then type in the desired path. Page 7 SCROLLING THROUGH THE FILE LIST ----------------------------------- Point to the Up or Down gadget and press the left mouse button. OR Point to the scroller gadget, press the left mouse button and position to desired location, release mouse button. ADDING GRAPHICS TO YOUR OWN PROGRAMS ------------------------------------- Two units are provided for reading and writing graphic files that are supported by Raster Master. Demos 1 thru 4 use these units. Demos 5 and 6 demonstrate how to link images to your executable. Because Raster Master uses the EGAVGA.BGI, images that are saved in BGF format can only be displayed with this driver. RWBgf.pas - A unit for reading and writing BGF files RWDef.pas - A unit for reading and writing DEF files Demo1.pas - Small program demonstrating how to read BGF files. Uses the RWBgf.pas unit. Demo2.pas - Small program demonstrating how to write BGF files. Uses the RWBgf.pas unit. Demo3.pas - Small program demonstrating how to read DEF files. Uses the RWDef.pas unit. Demo4.pas - Small program demonstrating how to write DEF files. Uses the RWDef.pas unit. Demo5.pas - Small program demonstrating how to link CON files to your program. Demo6.pas - Small program demonstrating how to convert a BGF file to an object file and link it to your program. Page 8 REGISTERING RASTER MASTER -------------------------- Why should you register Raster Master? 1) Registered users receive PCX file routines. This hard to find source for reading and writing PCX files will be available to you to include in your programs, no royalties, no need to buy expensive toolkits, and these routines work with the BGI. These are high level routines which means the code is clear and you don't have to worry about hardware addresses or registers. 2) You will also receive routines to read and write Windows ICO files. Thousands of these icons are floating around BBS's. For you this means instant clip art. 3) Also included will be the latest version of the program and a 'KEY' file. This 'KEY' file removes the opening and closing reminders for registration from the current version and any future updates. If you have decided that the program is worth registering please print a copy of REGISTER.TXT and fill it out. Page 9 ----------------end-of-author's-documentation--------------- Software Library Information: This disk copy provided as a service of Public (software) Library We are not the authors of this program, nor are we associated with the author in any way other than as a distributor of the program in accordance with the author's terms of distribution. Please direct shareware payments and specific questions about this program to the author of the program, whose name appears elsewhere in this documentation. If you have trouble getting in touch with the author, we will do whatever we can to help you with your questions. All programs have been tested and do run. To report problems, please use the form that is in the file PROBLEM.DOC on many of our disks or in other written for- mat with screen printouts, if possible. PsL cannot debug pro- programs over the telephone, though we can answer questions. Disks in the PsL are updated monthly, so if you did not get this disk directly from the PsL, you should be aware that the files in this set may no longer be the current versions. Also, if you got this disk from another vendor and are having prob- lems, be aware that some files may have become corrupted or lost by that vendor. Get a current, working disk from PsL. For a copy of the latest monthly software library newsletter and a list of the 3,000+ disks in the library, call or write Public (software) Library P.O.Box 35705 - F Houston, TX 77235-5705 Orders only: 1-800-2424-PSL MC/Visa/AmEx/Discover Outside of U.S. or in Texas or for general information, Call 1-713-524-6394 PsL also has an outstanding catalog for the Macintosh.